home *** CD-ROM | disk | FTP | other *** search
-
- ZipLab PLUS Version 1.6
- (C)Copyright 1991 by Jeffrey S. Morley
- November 16th, 1991
-
- Archive test program for PCBoard/ProDoor
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Table of Contents
- ===============================================================================
-
- Installation of ZipLab(PTEST.CFG) / Quick Start ........................... 2
- Explanation of items in PTEST.CFG / Example ............................... 4
- ProDoor Setup ............................................................. 5
- ZipLab Plus Version History ............................................... 6
- Credits ................................................................... 8
-
-
-
- What is ZipLab Plus?
-
- ZipLab is an alternative/replacement for the PCBTEST.BAT/PROUTEST.BAT
- files which are run by PCBoard/PRODOOR after a user uploads file(s). In
- the past, we have all run maybe PKUNZIP -T on each file, and if there
- were no CRC errors, all was considered well. There is a lot more we can
- do to protect ourselves and our users from unwanted files! ZipLab will
- do the following:
-
- * Test for CRC errors in the archive file.
- * Test for imbedded archive files and if found, CRC check those too.
- * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
- * Virus SCAN archive member files, using SCAN.EXE from McAffey.
- * SCAN inside archive files imbedded inside another archive file.
- * Remove all archive comments from the file.
- * Replace archive comments with your own. (Optional)
- * Delete unwanted BBS ads and/or other unwanted archive members as you define.
- * Test .GIF files for validity if you accept that file format (Optional)
- * Add the resolution of .GIF files to the description (Optional)
- * Reject programs older than a date (year) which you specify.
- * Adds most recent archive member date to the description (Optional)
- * Allow you to test outside of PCBoard/ProDoor, and use wildcards!
- * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
- * Run SCAN on files which you optionally pass without ZIP testing.
- * Calculate the CRC value of the archive, optionally placing this in the
- file description.
- * Optionally replace the description left by the user if FILE_ID.DIZ is
- found in the archive file.
- * Will make a notation in the CALLER file for the current node of any
- files which fail upload testing, including the failure reason.
- * Allows your users to run the TEST command in PCBoard to test files, but
- ZipLab will not remove the file if it fails DATE checking. The file will
- be moved for failure on other tests. You will be notified via the node's
- CALLER file of archives which fail PCBoard's TEST command.
- * Allow the use of non-standard commport IRQ addresses.
-
- SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE
-
-
-
- ** ZIPLAB IS NO LONGER "FREEWARE". REGISTRATION IS REQUIRED FOR ITS USE **
-
- PLEASE SEE THE ENCLOSED REGISTER.DOC FILE FOR REGISTRATION INFORMATION
-
-
- SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE
-
-
-
- Page 1 ZipLab Plus 1.6
-
-
-
- ********* A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE! *********
-
- REQUIRED FOR OPERATION:
-
- You must already have the following programs.....
-
- PKZIP.EXE - Phil Katz archive create program (version 1.01 +)
- PKUNZIP.EXE - Phil Katz archive extract program (version 1.01 +)
- LHA.EXE - Yoshi's archive program (version 2.13)
- ARJ.EXE - Robert Jung's archive program (version 2.10 +)
- TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
- SCAN.EXE - McAffey's virus detection program (any version)
-
- There are other small utility programs which I have bundled with this
- .ZIP. They may require registration for continued use. PLEASE SUPPORT
- SHAREWARE AND THE SHAREWARE CONCEPT! REGISTER THESE PROGRAMS IF REQUESTED
- TO DO SO!
-
- RECOM.EXE - Mike Loewen's ZIP file comment remover and date stamper.
- GIFTEST.EXE - Dave Navarro's .GIF file tester (part of GIFTSTxx.ZIP)
- DELF.COM - A version of DEL with no "Are you sure?" prompt written by me.
- (No registration required)
-
-
- Quick Start ---
-
- * NOTE! Since PCBoard is SHELLING out to run PCBTEST.BAT, there is
- limited memory available for PTEST.EXE. If you are running in a
- multitasking or other memory constrained situation, PTEST may not work!
- You should have at least 210k free memory when shelled out of PCBoard.
- If this is a problem, you may want to consider the VAROOM (overlay)
- version of PCBoard, which runs in considerably less memory than the
- standard PCB.EXE.
-
- The other option is to run PCBoard with the SET PCB = /SWAP environment
- variable. This will cause PCBoard to "swap" its code to the best
- available storage (EMS, DISK) whenever a SHELL function (external
- protocol, viewfile, and even DOORS if you have the SHELL column in
- DOORS.DAT(LST) set to "Y") is called. This method will cause a slight
- delay when SHELLING, but will provide the largest amount of available
- DOS memory for your external code.
-
- * Place the PTEST.EXE, SETUP.EXE and DELF.COM files into a directory which
- is in your DOS PATH.
-
- * UnZIP the enclosed supplemental utilities into directories in your DOS
- PATH. Make note of where you put them, you will need this information
- later.
-
- * Create, or use any existing directory to hold your PTEST configuration
- files. Change into this directory, and run SETUP.EXE once for each of
- your nodes. Be sure to give different configuration file names for each
- node. I use PTEST1.CFG and PTEST2.CFG. You may keep the particular
- node's configuration file in the PCBoard ROOT/HOME directory for the
- node, but this is not required.
-
- Page 2 ZipLab Plus 1.6
-
- * Fill in the following information when prompted by SETUP.EXE:
-
- - The [drive:\path\]filename.ext of the .CFG file you wish created.
- (This information will not be written to the .CFG file)
- - The type of modem HANDSHAKE you desire. This can be
- 0, 1, 2 or 3. 0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
- (Use 2 or 3 with an error correcting modem...)
- NEW!! - The IRQ address of the commport on this node, or '0' if you
- wish to use standard commport addresses. Use this ONLY if
- you have a commport which uses non-standard commport adresses.
- - The DRIVE:\PATH\NAME of your PCBOARD.DAT file for this node.
- - The name of your BBS system. 43 characters maximum.
- - The DRIVE and PATH to the directory where rejects will be
- placed pending manual sysop inspection.
- - The date (yyyy) which will be the minimum accepted year. ZIPs
- containing files older than this will be rejected.
- - A "Y" if you wish to replace the description left by the user
- with the contents of FILE_ID.DIZ (if found in the archive).
- A "N" if you do not wish to make use of this feature. No changes
- will be made in either case if FILE_ID.DIZ is not found.
- - A "Y" if you wish the "recent date" notation added to the file
- descriptions. A "N" if you do not wish this addition.
- - Information to appear in the description before the "recent date"
- This can be "CRC", "FILES", or "NONE"
- CRC = The CRC value of the archive
- FILES = The number of files in the archive
- NONE = Just that... none.
- - The fully qualified filename of the zip comment to add, or
- type "NONE" if you don't want to add a comment.
- - The fully qualified filename of a file which you may wish to
- add to the .ZIP, or "NONE" (please!) if you can refrain from
- this practice.
- - Full DRIVE:\PATH to PKZIP.EXE.
- - Full DRIVE:\PATH to PKUNZIP.EXE.
- - Full DRIVE:\PATH to LHA.EXE.
- - Full DRIVE:\PATH to ARJ.EXE.
- - Full DRIVE:\PATH to TDCHECK.EXE.
- - Full DRIVE:\PATH to SCAN.EXE.
- - Full DRIVE:\PATH to RECOM.EXE.
- - Full DRIVE:\PATH to GIFTEST.EXE (or NONE if not using)
- - Command line PARAMETERS you wish to pass to GIFTEST.EXE
- /B:2 /N:2 /C:C:\VGA\GIFTEST.CFG
- This example would tell GIFTEST.EXE that you are running
- PCBoard, that you are on node 2, and the location of your
- GIFTEST.CFG file. See the documentation for GIFTEST.
- Just enter NONE if you do not desire to use parameters.
- - A list, each on one line, of any extensions (.EXE, .TXT
- etc) Which will be passed without normal ZIP testing. SCAN
- will still be performed on these files. Any extensions
- other than .ZIP which do not appear in this .CFG file will
- be rejected by the process. The "." is optional. If .GIF
- appears in this list, GIFTEST will be used to test the
- integrity of the .GIF file.
- If you enter a "*" as one of the extentions, then ALL files
- will be passed through, with non-archived files being
- SCAN'd only.
- - A list, each on one line, of files which you wish deleted
- from .ZIP's before posting. This could include the famous
- "READMEOR.DIE", "BBS.AD", or other unwanted advertising.
- You may also have a file with these names listed one on
- each line, and pass the name of the file with an "@" before
- the name.
-
-
- Page 3 ZipLab Plus 1.6
-
-
- Sample PTEST.CFG file:
-
- 2
- 0
- C:\NODE1\PCBOARD.DAT
- The Interconnect BBS
- M:\HOLD
- 1990
- Y
- Y
- FILES
- C:\EXE\COMMENT.CMT
- C:\EXE\FILETO.ADD
- C:\ZIP\PKZIP.EXE
- C:\ZIP\PKUNZIP.EXE
- C:\ZIP\LHA.EXE
- C:\ZIP\ARJ.EXE
- C:\ZIP\TDCHECK.EXE
- C:\DIAGS\SCAN.EXE
- C:\EXE\RECOM.EXE
- C:\EXE\GIFTEST.EXE
- NEW!! /B:2 /N:2 /C:C:\VGA\GIFTEST.CFG
- .ROM
- .GIF
- @BBSADS.LST
-
- * Edit your existing PCBTEST.BAT file, and delete the whole thing except
- for two lines:
-
- Sample PCBTEST.BAT file:
-
- @ECHO OFF
- PTEST %1 C:\ZIPLAB\PTEST1.CFG %2
- ^^ NEW!!
-
- * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass
- command over to PTEST.EXE with the parameter containing the path
- and name of the file to be tested. PTEST will check out the file,
- placing any rejects in the holding directory you specified in the
- SETUP process above.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Page 4 ZipLab Plus 1.6
-
-
-
- * PRODOOR SYSOPS -
- You will need to set up your PROUTEST.BAT file like this:
-
- echo off
- rem -- process test uploads request - for ProDOOR 3.4
- rem -- %1-logfile, %2-testdir, %3-comport
-
- rem -- test each uploaded file individually
- proecho %3 ~~Testing uploads. Please wait...~
-
- SET PCBDOOR=PRODOOR
- for %%f in (%2\*.*) do COMMAND /c PTEST %%f drive:\directory\configfilename
- SET PCBDOOR=
-
- :end
- Replace the "drive:\..." stuff with the location and name
- of the PTEST configuration file for this node.
-
- Be sure you have enough ENVIRONMENT space to set up the
- PCBDOOR variable. If you are using DesqView, you may
- want to set PCBDOOR=xxxxxxx in your AUTOEXEC.BAT to be
- sure enough room is allocated in your DesqView partitions
- for this variable. The x's will be replaced by PRODOOR
- when PROUTEST.BAT is executed. I need this variable set
- to "PRODOOR", or PTEST won't know you are running out of
- ProDoor. You don't want to leave it set to PRODOOR though,
- since this could confuse things for other doors/processes.
- Thus the "SET PCBDOOR=" line. ZipLab will fully work
- with ProDoor, including display/modification of the file
- descriptions.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Page 5 ZipLab Plus 1.6
-
-
-
- NEW!! IN THIS VERSION *********************************************************
-
- ZipLab PLUS Version 1.6
-
- * Version 1.5 was opening the CALLER file in exclusive mode, which would
- cause a conflict with PCBoard in the SHELL mode. I now open the
- CALLER file in shared mode, and the "error 70" should be eliminated.
-
- * ZipLab will now support non-standard commport IRQ addresses. I have
- added a line to the .CFG file to allow you to set the IRQ for the
- commport. ZipLab will get the commport itself by looking in
- PCBoard.Dat. ZipLab will obey the IRQ setting you specify, but will
- use standard Base Port addresses. If your commport has non-standard
- IRQ AND Base Port addresses, ZipLab will most probably not function
- properly. If you have a standard commport, and are using COM1-COM4,
- please just enter a '0' (zero) in the field when prompted by SETUP.
-
-
- ZipLab PLUS Version 1.5
-
- * You must run SETUP.EXE and create a new .CFG file for this version!
-
- * A record of files which fail ZipLab's testing process will now be
- written to the CALLER file for the current node.
-
- * Users can now run the TEST command in PCBoard to check files before
- downloading, but the files will not be moved offline if they fail
- DATE checking. The user will be informed of any problems with the
- file, and names of files which fail TEST will be written to the
- CALLER file for the current node. A Change is required to your
- PCBTEST.BAT file to support this feature!
-
- @ECHO OFF
- PTEST %1 C:\P2\PTEST.CFG %2
- ^^NEW!!
-
- Note the additon of %2 at the end of the command line. PCBoard will
- pass the word TEST as %2 when using the TEST command from the board,
- and will pass nothing in %2 when testing an upload.
-
- * The user was being displayed the name of the file including drive and
- path when a file failed testing. This has been modified to show only
- the filename, for security reasons.
-
- * In order to allow maximum flexibility in using GIFTEST for testing
- .GIF files, ZipLab will no longer make ANY assumptions about what
- command lines need to be passed to GIFTEST.EXE. You should use
- GTSETUP.EXE (from GIFTEST) to configure GIFTEST, and then use the
- new item in the PTEST.CFG file to pass any additonal parameters you
- require. Please run SETUP.EXE to effect the change required in the
- PTEST.CFG file, and read the documentation for GIFTEST to see what
- command line parameters you require.
-
-
-
- ZipLab PLUS Version 1.4
-
- * A CONFIGURATION CHANGE IS REQUIRED FOR THIS VERSION!!! RUN SETUP.EXE!
-
- * Added an entry in the .CFG file for the type of information to appear at
- the beginning of the line added to the file description. The choices
- are:
-
- ENTRY: MEANING:
-
- CRC The CRC32 value of the archive file.
- FILES The number of files in the archive
- NONE Insert only the date information.
-
- Note that if you see two files with the same CRC32, they are the SAME
- file, even if the names and dates are different. How you use this
- information is up to you for now, although I plan for a future release
- of ZipLab to have the capability to search a database of existing file
- CRC32's on your system, and reject re-named duplicates.
-
- Note as well that calculating the CRC32 will cause a momentary delay
- during the "checking CRC" process. The delay will be a second or two on
- a small file, and up to 15-20 seconds on a file around 1meg.
-
- * Added an entry in the .CFG file which if "Y" will search the archive
- for FILE_ID.DIZ. If FILE_DIZ is found, ZipLab will replace the
- description left by the user with the description contained in
- FILE_ID.DIZ. Set this to "N" if you do not wish this feature, but
- I do strongly recommend it. FILE_ID.DIZ is a standard format file
-
- Page 6 ZipLab Plus 1.6
-
-
- containing the author's description of the archive contents. Why not
- get the description from the "horses mouth"? Not all Shareware authors
- are inserting FILE_ID.DIZ yet, but it is becoming increasingly popular.
-
- * Please run SETUP.EXE to create the new .CFG file(s) for your system.
-
-
-
- ZipLab PLUS Version 1.3
-
- * No configuration file changes required for this version.
-
- * Corrected several things which were not working correctly.
-
- 1) If a file failed any test, ZipLab was doing everything it was supposed
- to, but then exiting with an ERROR 76. Fixed.
- 2) A flag on ARJ was set wrong, so that imbedded files with the same
- name as a file in the top level .ARJ would cause an "overwrite?" pause.
- 3) SCAN'ing for virus infestation was not working properly in "imbedded"
- archives. ZipLab will now properly SCAN executables and overlays
- contained in imbedded archives.
- 4) I broke CRC checking in archives and .TD0 files in the 1.2 version.
- This has been fixed. Archives and .TD0 files inside the top level
- archive will now be CRC checked properly.
- 5) I was previously only running SCAN against .EXE and .COM files in
- the archive. I have added .OVL (which SCAN recognizes as executable).
-
-
- ZipLab PLUS Version 1.2
-
-
- * No configuration file changes required for this version.
- * Fixed a tricky little problem with an ASM routine I use to RD directories.
- The routine was not properly killing the directory if SET ZIPLAB= was used
- to set the "work" directory to a RAM drive. This should now work fine.
- There were other instances where some machines (or DOS') were having
- trouble with removing the "work" directory. These are also fixed...
-
- * Fixed a problem where PKUNZIP was stopping with a "do you want to overwrite?"
- message (which we couldn't see), if a file had imbedded paths with files of
- the same name in different paths. This should no longer be a problem.
-
- * The LHARC program is now called LHA.EXE in newer versions. ZipLab will
- work properly with either LHARC.EXE or LHA.EXE, but defaults to LHA.EXE.
-
-
- ZipLab PLUS Version 1.1
-
- * No configuration file changes required for this version.
-
- * I had left in a lot of "local" display of the testing process, so that I
- could get useful debugging information back from my users. I have now
- removed as much as possible of the local displays, and the process should
- look a lot less jerky to the watching sysop.
-
- * Added a the ability to use ".*" as one of the extensions which will be
-
- Page 7 ZipLab Plus 1.6
-
-
- passed without archive testing. If you put ".*" in using Setup.Exe, ALL
- files will be passed. Files passed with this method OR by specifing
- particular extensions in PTest.Cfg will still be SCAN'd for virus'.
-
- * Fixed a problem where in LOCAL mode using wildcards, a directory which
- contained a mixture of archive types (ZIP, ARJ, LZH) would cause problems
- after testing the first type.
-
- * Some users were having problems reassigning the "working" directory. This
- is by default PTEST.DIR under the current directory (C:\PCB\PTEST.DIR\ for
- most sysops), but can be changed to another directory with an environment
- variable. In your Autoexec.Bat, the line "SET ZIPLAB=d:\path" will allow
- any drive and directory to be used for the "working" directory. PLEASE,
- remember that this directory will be used and DELETED when the process is
- done. Several people tried to use C:\PCB or just C:\ and experienced
- unfortunate effects. I have tested ZipLab PLUS with a ramdrive as the
- "working" directory, and it seems to work fine. There may be a problem
- with directories containing a "." in early versions of DOS. if you are
- not running DOS 4.0 or later, and are having problems with ZipLab Plus,
- you may want to try reassigning to another directory name.
-
- * Descriptions will not be modified if you are not running PCBoard 14.5(a)
- or later. Early 14.5 versions didn't save the descriptions in the same
- location during the testing process, and ZipLab Plus won't find them.
-
-
- ZipLab PLUS Version 1.0
-
- * Configuration file changes required for this version! (from old ZipLab)
-
- * This is the new ZipLab PLUS! A lot of hard work has gone into this and
- earlier versions, and I will be requiring a *REGISTRATION FEE* with
- this version. See REGISTER.DOC for details on how to register ZipLab
- PLUS.
-
- * ZipLab will now test .ARJ and .LZH files, as well as the .ZIP
- format. You will need to have ARJ.EXE and LHA.EXE if you accept
- these formats, and a change to the .CFG file is *REQUIRED* to tell
- PTEST where they are. You must put them in the PTEST.CFG file, even
- if you don't accept these formats, and don't have the programs...
- Just lie to it.
-
- * ZipLab now fully supports ProDoor as well as PCBoard.
-
- * You may now run ZipLab while out of the bulletin board system and use
- wildcards (* or ?) in the testing procedure. This will allow you to test
- existing archive file(s) on your system. *NO* changes will be made to
- existing descriptions. To enable this feature, place the word LOCAL at
- the end of the PTEST command line.
-
- EXAMPLE: C:\ZIPLAB>PTEST m:\pcb\dir1\*.zip ptest.cfg LOCAL
-
- * ZipLab will now SCAN archives inside archives to test for virus
- infestation.
-
- * You may now have rejected uploads left in your private directory if you
-
- Page 8 ZipLab Plus 1.6
-
-
- prefer this setup. Set the "holding" directory to the location of your
- "private" or "upload" directory (whichever you wish), and the file(s)
- will remain there. The description(s) will be posted to your "private"
- dir file. This corrects a situation where sysops trying to do this with
- earlier releases of ZipLab would lose the rejected file.
-
- * By default, ZipLab will use a directory called PTEST.DIR under the
- current directory for unzip'ing and testing purposes. This directory
- will be erased and removed by ZipLab at the end of the run. If you wish
- to use another directory for this purpose (like a RAM drive to improve
- speed), set the DOS environment variable "ZIPLAB".
-
- EXAMPLE: SET ZIPLAB=E:\WORKDIR
-
- * You may choose to add a file to the archive package, by adding the
- appropriate information to the PTEST.CFG file. I am opposed to this
- practice, but don't desire to tell anyone how to run their shop.
-
- * The ORIGINAL file date of the archive file is now retained. Earlier
- versions of ZipLab would set the archive file date to the date of the
- newest member in the archive. This was required for age testing, but is
- no longer.
-
- * ZipLab will NOT leave behind "hidden, read-only or system" files
- which were imbedded in archives. They will be tested, and properly
- deleted when the tests are finished.
-
- * ZipLab now uses GIFTEST.EXE to test .GIF files (if permitted). This
- program by Dave Navarro will allow you to set up a GIFTEST.CFG file -
- giving you even more control over .GIF testing. An addition to your
- PTEST.CFG file is required to support this. Please read the docs with
- GIFTSTxx.ZIP for details on how to best set up the GIFTEST.CFG file.
- YOU MUST REGISTER GIFTEST TO USE IT!
-
- * You may now put all BBS advertising file names into a text file, one
- on each line. In PTEST.CFG, place an "@" before the name of this text
- file, and ZipLab will delete all listed advertising files in one pass.
- THIS IS MUCH FASTER for those with multiple advertising files to reject.
-
-
-
-
- ***********************************************************************************************
-
- This program was written in QuickBasic 4.5, with some help from
- Hammerly Computing's ProBas 4.01. I have also included a few utilities
- which PTEST will use in the course of testing. These utilities are the
- property of the authors, and you are strongly requested to register them
- if you continue to use ZIPLAB PLUS.
-
- Jeffrey S. Morley
- The Interconnect BBS
- (703)425-2505
-
- PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
-
- (C)Copyright 1989-1991 by Jeffrey S. Morley
-
- Page 9 ZipLab Plus 1.6
-
-